Skip to content

Migrate documentation theme to PyData Sphinx theme#192

Merged
DanielAvdar merged 2 commits intomainfrom
copilot/fix-184
Jun 6, 2025
Merged

Migrate documentation theme to PyData Sphinx theme#192
DanielAvdar merged 2 commits intomainfrom
copilot/fix-184

Conversation

Copy link
Contributor

Copilot AI commented Jun 6, 2025

This PR migrates the documentation theme from the Read the Docs theme to the PyData Sphinx theme, providing a more modern and feature-rich documentation experience.

Changes Made

  • Dependencies: Replaced sphinx-rtd-theme>=3.0.2 with pydata-sphinx-theme>=0.15.0 in pyproject.toml
  • Theme Configuration: Updated html_theme from "sphinx_rtd_theme" to "pydata_sphinx_theme" in docs/source/conf.py
  • Theme Options: Added PyData-specific configuration including:
    • GitHub repository integration with direct links
    • Edit page button functionality
    • Improved table of contents display
    • Left-aligned navigation bar
  • Code Cleanup: Removed duplicate sphinx.ext.autodoc extension entry

Benefits

The PyData Sphinx theme provides:

  • Modern, responsive design that works well on mobile devices
  • Better GitHub integration with edit buttons and repository links
  • Improved navigation and search functionality
  • Consistent styling with other scientific Python projects
  • Enhanced accessibility features

Testing

  • ✅ Documentation builds successfully with the new theme
  • ✅ All existing documentation pages render correctly
  • ✅ GitHub integration features work as expected
  • ✅ Make targets (make doc, make doctest) continue to work

The migration maintains full backward compatibility while providing an improved user experience for documentation readers.

Fixes #184.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

- Replace sphinx-rtd-theme with pydata-sphinx-theme in dependencies
- Update html_theme setting in Sphinx configuration
- Add PyData theme configuration options including GitHub integration
- Remove duplicate sphinx.ext.autodoc extension entry
- Test documentation builds successfully with new theme

Co-authored-by: eh-main-bot <171766998+eh-main-bot@users.noreply.github.com>
Copilot AI changed the title [WIP] Migrate documentation theme to PyData Sphinx theme Migrate documentation theme to PyData Sphinx theme Jun 6, 2025
Copilot AI requested a review from EH-MLS June 6, 2025 15:36
Copilot finished work on behalf of EH-MLS June 6, 2025 15:36
@DanielAvdar DanielAvdar marked this pull request as ready for review June 6, 2025 16:51
@DanielAvdar DanielAvdar merged commit 952e55a into main Jun 6, 2025
43 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migrate documentation theme to PyData Sphinx theme

3 participants